Mangos Web Enhanced

-This is a Front end/CMS project for Mangos. This project is a continuation of MangosWeb 
(http://tools.assembla.com/mangosweb). Credits go to Jimmy06. This is just my version of
MangosWeb.

Mangos Web Enhanced SVN: https://mw-enhanced.svn.sourceforge.net/svnroot/mw-enhanced/
Mangos Web Enhanced Main Project Page: http://mw-enhanced.sourceforge.net/

Table of contents
-----------------

1. How to install
	a.Requirments
	b.Installation
	c.Configuration
		I.   Webpage
		II.  player online map for mangos
		III. Character Transfer

2.How to update

3.Interface and admin panel

4.Setting up news forum

5.Setting up donation panel

6.Extra's

7.Setting up Vote System

8.Setting up chat system

9.Configuring the Character transfer and rename system

---------------------------



------------------
1. How to install
------------------


1-A Requirments: Apache with Mysql & PhP support
	- Apache v2.2.x
	- MySQL 5.0.x
	- Php version 5.x
	- GD compiled into Php (In windows, enable GD exetension in php.ini file).

2-B Installation
	-In MySql, run the "full_install.sql" from the SQL folder, on the "realmd" database.
	-Make sure all folders are in you Web root folder.
	-Rename the DISABLE_INSTALLER.php to something else.
	-Open your browser and type www.yoursite.com/install/
	-Follow the on page instructions.
	-Once complete, rename the old DISABLE_INSTALLER.php back to original.
	-Create a database called "characters_temp" and run the "characters_temp.sql" on it
	-Create a database called "chat" run the "chat.sql" on "chat" database.
	-Run the "vote_realmd.sql" on you "realmd" database.
	

2-C Configuration
	-to configure the Mainsite, open "config/config.xml"
	-To configure the player map, open "config/playermap_config.php"
	-To configure the character rename, open "components/admin/chartools/charconfig.php"
	-to configure the vote system, open "/README/vote_installation.txt" 
and follow instructions.
	-To configure the chat system, edit "components/chat/libs/config.php"  and read "components/chat/readme.txt"
Chat can be enabled/disabled through the "config/config.xml" Look for <chat><enable>1</enable></chat>


-----------------
2. How to update
-----------------

1. right click on your MangosWeb Enhanced folder and select SVN Update.
-MAKE SURE to backup your realmd database, and all your config files before updating!

SVN: https://mw-enhanced.svn.sourceforge.net/svnroot/mw-enhanced/

--------------------------------
3. Web interface and Admin Panel
--------------------------------

Browse to your MaNGOSWeb page and accept the ToS. Login to the MaNGOSWeb using 
the administrator account you created in 4.a Installing SQL files.

Go to Context menu: > Admin Panel. Mousing can be a little tricky with the drop-down
menu. Hopefully the will fix this with future releases.

From the Admin Panel, you can set the variables for:
  - Users
  - Site Settings
  - Realms (here you can add existing Realms. This is not the same as creating new ones)
  - Reg Keys (these are registration keys mailed to users to validate their accounts)
  - Languages (here you can add or delete languages from the Choose Language: menu
  - Donate Admin (configure your site to accept donations and to give reward/items for
                  donations)
  - Backup Management (This one I'm not too sure about, I bet the programmer knows!)
  - Add News
  - Edit News
  - Configure Chat (I believe this is java or javascript based and might come in handy)

--------------------------------------------
4. Setup News Forum to display on main page
--------------------------------------------

The news forum is not set up on the site initially. You will probably want to set 
this up, since news posting does not work without it. 

To begin:

 1. Login with your level 4 account (root admin access)

 2. Go to Context menu: > Admin Panel, click Forum

 3. Create new category and leave the order at 1. (News would be a good suggestion for
    a category, and if you changed your config/config.xml to a differen number for this section
    that is the number you should use.)

 4. News will now appear at the top of the page, click it.
 
 5. Create a new Forum (topic?). You may want to give this a name that includes the name
    of your site. This will be in the RSS if you choose to publish this on the 
    internet.  Leave the order at one, unless you specified others in the config/config.xml.
    If you allow members to post new topics, then you may want to close this forum to
    the public.

    a) To close a forum, click the first icon - a page - a page next to the Topic.
       To open a closed forum, click the first icon again.

    b) To hide a topic from view without deleting it click the middle icon - a page 
       with a blue exclamation. To reveal a hidden forum, click the middle icon again.

    c) To post to a click the third icon - a page with a pencil. 
		  
 6. To post or edit a closed forum go to:
    Context menu: > Admin Panel > Add or Edit News

If you follow these steps exactly, and leave Default Component to frontpage, topics
you post here will appear on the main page. Very Blizzlike. And you can probaby see
why you don't want this section cluttered up with member comments :D.

-----------------------------------
5. How to setup the DONATION SYSTEM
-----------------------------------

To auto grant access to your donation template:
Run 482_account_extended_auto_granting.sql or 482_account_extended_manual_grating.sql,
to grant acccess manually.

    a) Create a premier paypal account. (It's free)
	
    b) From the PayPal menu, go to Profile > Under selling Preferences > Instant Payment 
       Notification Preferences.
    c) Select Instant notification
    d) Enter the full path including your domain name to donation.php in the root of your
       MaNGOS directory. 
       Example: http://you-domain-or-ip/subdirectoryifyouhaveone/donation.php

Everyone likes a little pat on the back for their donations, unless they're good
samaritans like me...and just doing good deeds is satisfaction enough. If they're not
like me :P, then you may want to reward them for their donations

To create, edit, or send donation packs and items, go to:
Context menu: > Admin Panel> Donate Admin or see table `donation_template`in the
realmd database.

*NOTE* Whenever somebody donates, it will show up in the donate admin as "send not sent items". An
admin or GM must send these items from the donate admin in order to send the rewards to donaties.

----------
6. Extra's
----------
 -To change Default size that can be uploaded of Wallpapers and Screenshots go to:
/templates/offlike/media/media.screen.php Ln=7, Col=46 
Change 2 to whatever you want. Example: 2=200k, 4=400k, 10=1mb

/templates/offlike/media/media.wallp.php   Ln=7, Col=46 
   Change 2 to whatever you want Example: 2=200k, 4=400k, 10=1mb

 -To give some or yourself root admin access to your webpage: Select the 
account_extend table and look-up your account in the "account_id" 
column. Your account ID is cross-referenced in the from the corresponding 
account table. Looking for it in the account table first maybe easier sinceyou can see 
the user names associated with the account ID.
Locate the g_id column for your account_id in the account_extend table. Modify
this to a 3 or a 4 to give yourself admin(3) or root admin(4) access to the 
MaNGOSWeb Enhanced.

--------------------------------------------
7. Setup the vote system
--------------------------------------------

1. Import \sql\vote_realmd.sql to your realmd table - it is just adding new tables (not altering the existing ones).
2. All Settings are in "components/community/vote/config.php".
3.1 Your server remote access should be turned on (look in your server config file for Ra.Enable).
3.2 Your telnet connection to the server remote must be working properly.
3.3 For the remote access user and pass you can use an existing mangos/trinity ACCOUNT or to CREATE a new one.
Only know that its GM level must be set according to (not lower than) Ra.MinLevel in the server config file
and this user must have "send money" and "send items" commands active. If you have any problems, check the ra.commands.log file
that your sever creates "C:\YOUR REPACK\mangos\ra.commands.log"
4. If using trinity, open your "account_access" table in realmd database. Set realm ID for your telnet account to "-1"
5. To adjust the rewards or site links etc. "components/community/vote/tabs/sites.php or
"components/community/vote/tabs/rewards.php

P.S. If you like my work, please don't remove "Created by SUPERGADGET".

NOTE! to disable the vote system, open "components/community/community.vote.php"...find ""if ((int)$MW->getConfig->vote_system->enable = 1)""
change the "1" to "0".

To remove the "click here to vote for us" logo on the frontpage, open "config/config.xml" Find <votelinks> add "<!--"
infront of that and add "-->" after </votelinks>. This will disable the vote system logo. 
--------------------------------------------
8. Setup the chat system
--------------------------------------------

1. Create a database called chat, or use any exsiting database
2. Run the "/sql/chat.sql" on your chat database.
3. Configure your chat by editing "components/chat/lib/config.php"


NOTE! to disable the chat system, open "components/community/community.chat.php"...find ""if ((int)$MW->getConfig->chat->enable = 1)""
change the "1" to "0".

--------------------------------------------
9. Configuring the transfer and rename system
--------------------------------------------

1.The config file is located "components/admin/chartools/charconfig.php"